getTerminals

HTTP method: GET

The getTerminals method returns a list of the terminals you have access to, and detailed information about each terminal. The method does not take any parameters.

For dynamic payment terminal matching please refer to metadata page

Test URL https://testgateway.altapaysecure.com/merchant/API/<method>
Production URL https://<YourShopName>.altapaysecure.com/merchant/API/<method>

The table shows the most pertinent response values for the method. For a complete list of API response parameters, see API Response structure (XML).

Method configuration is defined per individual acquirer. Each item of configuration is identified by payment method identifier (such as GooglePay or ApplePay) and the specific acquirer name.

This allows multiple acquirers to be used for the same payment methods seamlessly.

The getTerminals method returns a list of the terminals together with the method identifier:

<MethodConfigurations>
    <MethodConfig method="MarketpayCardAcquirer" identifier="CreditCard"/>
    <MethodConfig method="MarketpayWalletAcquirer" identifier="GooglePay">
        <MerchantId>0123456789001234567890</MerchantId>
        <MerchantName>AltaPay</MerchantName>
    </MethodConfig>
</MethodConfigurations>

XML response

<?xml version="1.0"?>
<APIResponse version="20170228">
    <Header>
        <Date>2020-01-07T23:43:20+01:00</Date>
        <Path>API/getTerminals</Path>
        <ErrorCode>0</ErrorCode>
        <ErrorMessage></ErrorMessage>
    </Header>
    <Body>
        <Result>Success</Result>
        <Terminals>
            <Terminal>
                <Title>AltaPay Multi-Nature Terminal</Title>
                <ShopName>Test shop</ShopName>
                <Country>DK</Country>
                <LogoUrl>https://example.com/images?q=1234567</LogoUrl>
                <Translations>
                    <Translation language="da">
                        <Field name="description">Kreditkort</Field>
                    </Translation>
                </Translations>
                <PrimaryMethod>
                    <Nature>EPayment</Nature>
                    <Identifier>SEPA>/Identifier>
                    <SupportedAgreementTypes>
                        <AgreementType>recurring</AgreementType>
                    </SupportedAgreementTypes>
                </PrimaryMethod>
                <Natures>
                    <Nature>CreditCard</Nature>
                    <Nature>EPayment</Nature>
                    <Nature>IdealPayment</Nature>
                    <Nature>Invoice</Nature>
                </Natures>
                <Currencies>
                    <Currency>DKK</Currency>
                    <Currency>EUR</Currency>
                </Currencies>
                <Methods>
                    <Method>Shift4Acquirer</Method>
                    <Method>Przelewy24Acquirer</Method>
                    <Method>KlarnaPaymentsAcquirer</Method>
                    <Method>IdealAcquirer</Method>
                    <Method>SepaAcquirer</Method>
                </Methods>
            </Terminal>
            <Terminal>
                <Title>AltaPay BankPayment Terminal</Title>
                <Country></Country>
                <Natures>
                    <Nature>BankPayment</Nature>
                </Natures>
                <Currencies>
                    <Currency>EUR</Currency>
                </Currencies>
                <Methods>
                    <Method>IdealAcquirer</Method>
                </Methods>
                <Metadatas>
                    <Metadata>
                        <KeyValue key="Key">Value</KeyValue>
                    </Metadata>
                    <Metadata>
                        <KeyValue key="Key2">Value2</KeyValue>
                    </Metadata>
                </Metadatas>
            </Terminal>
        </Terminals>
    </Body>
</APIResponse>